home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr05 / dlgx14.zip / README.TXT < prev    next >
Text File  |  1993-07-01  |  20KB  |  497 lines
  1. WINDOWS DIALOG EXTENSIONS VERSION 1.40
  2.  
  3. Welcome to the Windows Dialog Extensions. This file gives details about
  4. installation and use of the programs and how to register if you find
  5. them useful.
  6.  
  7. Sections in this are document:-
  8.  
  9.    FILE PACKING LIST
  10.    HOW TO INSTALL THE WINDOWS DIALOG EXTENSIONS
  11.    ABOUT THE FILE DIALOG EXTENSIONS
  12.    ABOUT DIALOG 3D
  13.    HOW TO REGISTER THE WINDOWS DIALOG EXTENSIONS
  14.    DISCLAIMER AND AGREEMENT
  15.    NOTES
  16.    VERSION HISTORY
  17.    NOTE TO EXISTING USERS
  18.  
  19. -----------------------------------------------------------------------
  20.  
  21. FILE PACKING LIST
  22.  
  23. Two utilities are provided as follows:-
  24.  
  25. Common File Dialog Extension Library (CFDEL)
  26.  
  27. This utility adds useful file manipulation buttons to file load and
  28. save dialogs in your windows apps (see below for full description)
  29.  
  30. Dialog 3d (Dialog3d)
  31.  
  32. This utility adds grey '3d style' dialogs (as in MS Excel 4 and Access)
  33. to all windows applications.
  34.  
  35.  
  36. You should have received the following files:-
  37.  
  38.    COMMDLG.DLL    The file extensions library
  39.    3DDIALOG.EXE   Dialog3d program
  40.    DLGCTRL.CPL    Control panel applet for Dialog3d
  41.    DETAILS.DLL    DLL containing common routines to above
  42.    DLG3D.DLL      Dilaog3d runtime library
  43.    CTL3D.DLL      Microsofts redistributable 3d library
  44.    CFDEL.HLP      Help for common file dialog extenders
  45.    REGISTER.HLP   Help file for registering
  46.    README.TXT     This file
  47.  
  48.  
  49. -----------------------------------------------------------------------
  50.  
  51. HOW TO INSTALL THE WINDOWS DIALOG EXTENSIONS  -  READ, DON'T GUESS!
  52.  
  53. Firstly the Windows Dialog Extensions require Windows 3.1 and will not
  54. work properly under 3.0.
  55.  
  56. Installation of the extensions must be done from DOS (not a DOS box
  57. under Windows) as follows:-
  58.  
  59.  
  60. To install the Common File Dialog Extensions:-
  61.  
  62. *  First, rename the file commdlg.dll in the Windows system
  63.    directory (usually c:\windows\system) to commdlg2.dll. THIS
  64.    STEP IS ESSENTIAL!  WINDOWS MAY CRASH IF YOU OMIT IT!
  65.    C:\WINDOWS\SYSTEM\COMMDLG.DLL  -->  C:\WINDOWS\SYSTEM\COMMDLG2.DLL
  66.  
  67. *  Next copy the file commdlg.dll from the Dialog Extensions
  68.    distribution to the Windows system directory.
  69.    DLGX14\COMMDLG.DLL   -->   C:\WINDOWS\SYSTEM\COMMDLG.DLL
  70.  
  71. *  Finally copy the files details.dll, register.hlp and cfdel.hlp 
  72.    from the Dialog Extensions distribution to the Windows 
  73.    system directory (usually c:\windows\system) or to WINDOWS.
  74.  
  75.  
  76. To install Dialog 3d:-
  77.  
  78. *  Copy ctl3d.dll, dlgctrl.cpl and dlg3d.dll from the Dialog 
  79.    Extensions distribution to the Windows system directory.
  80.  
  81. *  Copy 3ddialog.exe, details.dll and register.hlp (if not copied 
  82.    above) to the Windows system directory
  83.  
  84. *  Add the program '3ddialog.exe' as the first program in the 'run='
  85.    line of the win.ini file (found in the windows directory). Use any
  86.    ASCII text editor (notepad for example) to do this.
  87.  
  88.  
  89.  
  90. When you now run windows the Windows Dialog Extension will automatically
  91. be installed and activated.
  92.  
  93. You should ensure that no other versions of any of these files are
  94. located on the path earlier than the ones in windows\system, otherwise
  95. the extensions may not be activated.
  96.  
  97.  
  98. -----------------------------------------------------------------------
  99.  
  100. ABOUT THE FILE DIALOG EXTENSIONS LIBRARY
  101.  
  102. The File Dialog Extensions attach a number of buttons to the bottom of
  103. a file load or save dialog from the commdlg.dll library supplied with
  104. Windows 3.1. Most Windows applications use this library for obtaining
  105. file names from the user. Thus when you got to load or save data from
  106. within an application the buttons will be available on the file dialog
  107. displayed allowing the manipulation of existing files without having to
  108. switch to the File Manager. The buttons that appear are configurable, as
  109. is the size that file dialogs are displayed. The buttons that may be
  110. added to the bottom of the file dialogs are:-
  111.  
  112.    Make Dir
  113.    Delete
  114.    Rename
  115.    File Info
  116.    Make Backup
  117.  
  118. The extensions library also adds new items to the System Menu of
  119. file dialogs. These entries are:-
  120.  
  121.    Make Directory...
  122.    Delete...
  123.    Rename...
  124.    File Info...
  125.    Make Backup
  126.    Options...
  127.    Help...
  128.    About...
  129.  
  130. Note that the File Dialog Extensions work by intercepting calls on their
  131. way to COMMDLG2.DLL (originally COMMDLG.DLL as supplied with Windows).
  132. Thus you MUST still have this file for the extensions to work.
  133.  
  134.  
  135. MAKE DIRECTORY BUTTON
  136.  
  137. Clicking on the Make Dir button will allow a directory to be created in
  138. the current directory (as displayed to the top right of the file dialog).
  139. You will be asked for the name of the directory, enter this and click OK to
  140. create it. If the directory is created successfully the file dialog will
  141. update to show the new directory. If an error occurs when trying to create
  142. the directory an error message box will be displayed. Click Cancel to exit
  143. the Make Directory dialog without attempting to create a directory.
  144.  
  145.  
  146. DELETE FILE BUTTON
  147.  
  148. Clicking on the Delete button will delete the currently selected file. This
  149. is the file highlighted in the file dialogs list of files. If no file is
  150. selected the Delete button will be disabled and no deletions can take place.
  151. If the Confirm Deletes option is enabled you will be asked for confirmation
  152. of the deletion, click Yes to delete or No to abort. If Confirm Deletes is
  153. not enabled the deletion will take place immediately after you click the
  154. Delete button. The file dialog file list will update after the deletion. An
  155. error message box will be displayed if the deletion fails.
  156.  
  157. If the application using the file dialog allows multiple files to be selected
  158. all the selected files will be deleted. If the Confirm Deletes option is
  159. enabled you will be prompted to confirm deletion for each file in turn.
  160. Selecting Cancel on a confirmation dialog will stop the deletion of the
  161. currently displayed file and all further selected files.
  162.  
  163.  
  164. RENAME FILE BUTTON
  165.  
  166. The Rename button allows the renaming of the currently selected file. This
  167. is the file highlighted in the file dialogs list of files. If no file is
  168. selected the Rename button will be disabled and no renaming can take place.
  169. Clicking on the Rename with a file selected results in a dialog asking for
  170. the new name for the file. This should be entered and OK selected to rename
  171. it. Click Cancel to abort renaming of the file. An error message box will
  172. be displayed if renaming of the file fails.
  173.  
  174. If the application using the file dialog allows multiple files to be selected
  175. you will be prompted for a new name for each selected file in turn. Click Yes
  176. to rename, No to skip to the next file and Cancel to cancel the renaming of
  177. the current and all further selected files
  178.  
  179.  
  180. FILE INFORMATION BUTTON
  181.  
  182. The File Info button will display information about the currently selected
  183. file. This is the file highlighted in the file dialog list of files. If no
  184. file is selected the File Info button will be disabled. The information
  185. displayed for a file is its name, size, time and date of last modification
  186. and its file attributes. This information is not editable. Click on OK when
  187. finished viewing the information.
  188.  
  189. If the application using the file dialog allows multiple files to be selected
  190. you will be shown details of each selected file in turn. Click OK to move to
  191. the next file and {\cf1Cancel\cf0} to stop viewing the selected list of files.
  192.  
  193.  
  194. MAKE BACKUP CHECKBOX
  195.  
  196. The Make Backup checkbox is only enabled when saving. If it is checked
  197. before selecting OK to save a file, a backup will be made of any existing
  198. file with a name matching that of the file being saved. This is done by
  199. copying the existing file to a similarly named file with the extension .BAK.
  200. An error message box will be displayed if the backup fails.
  201.  
  202.  
  203. NEW SYSTEM MENU ITEMS
  204.  
  205. The first five new system menu items duplicate the buttons described above
  206.  
  207.  
  208. OPTIONS DIALOG
  209.  
  210. Selecting Options... from the System Menu of a file load or save dialog
  211. will bring up the file extensions Options dialog box. This dialog allow the
  212. customisation of the extensions and covers three areas. Firstly, the Show
  213. checkboxes control which of the possible five extension buttons are added
  214. to file dialogs. The next section is the Options checkboxes. Currently this
  215. has one checkbox allowing the enabling or disabling of the Confirm Deletes
  216. dialog when deleting files. The final set of buttons allow the selecting of
  217. the dialog size. This may be Small, Medium or Large. Small is the same as
  218. the standard commdlg.dll file dialog, Medium has two columns in the file
  219. list box and is slightly deeper and Large is almost full screen on a VGA
  220. monitor and gives three columns in the file list box.
  221.  
  222. Note that the file list on the medium or large settings is a multi-column
  223. list and you scroll it horizontally to display any files 'off screen'.
  224.  
  225. Sometimes you will find the size buttons disabled (shown shaded), this
  226. occurs when the library is being used with an application that supplies
  227. its own dialog template rather than using the one in commdlg.dll. Because
  228. of this the extensions library doesn't know what the dialog will look like
  229. and so does not attempt to resize it and also disables disables the size
  230. buttons on the Options dialog when called from such a file dialog. The
  231. library still attaches the file buttons to the bottom of such a dialog
  232. and these can be used as normal.
  233.  
  234. Click OK to set the selected options and Cancel to ignore the changes.
  235.  
  236. The options selected in the dialog are saved in a section in the win.ini
  237. file and will be used in later windows sessions.
  238.  
  239.  
  240. HELP
  241.  
  242. Selecting Help... from the System Menu give help on the common dialog
  243. extensions facilities in the standard Windows format.
  244.  
  245.  
  246. ABOUT DIALOG
  247.  
  248. Selecting About... from the System Menu of a file load or save dialog will
  249. bring up the file extensions About dialog box. If the copy is registered it
  250. will show the registered user and serial number. If it is unregistered it
  251. will show *** UNREGISTERED COPY *** and Serial Number : XXXXXX. Clicking
  252. OK on an unregistered copy of the extensions will result in the Shareware
  253. Reminder dialog being shown, offering the user the chance to register the
  254. program. Clicking OK on a registered copy simply returns to the file dialog.
  255.  
  256.  
  257. SELECTIVE DISABLING
  258.  
  259. In some cases, using the file extensions causes a problem in conjunction
  260. with another program.  To avoid this, add the following information to your
  261. WIN.INI file:
  262.  
  263. [Commdlg ext disable]
  264. d:\path\fullname.exe=OFF
  265.  
  266. where the filename you give must be the full path & name of the program
  267. you're finding troublesome.  The dialog extensions will then avoid this
  268. program.
  269.  
  270.  
  271. -----------------------------------------------------------------------
  272.  
  273. ABOUT DIALOG 3D
  274.  
  275. Dialog 3d is now supplied with a control panel applet to allow you to 
  276. select different dialog 'looks'. If dlgctrl.cpl is installed as described
  277. above when you run control panel there will be a new applet icon '3D'.
  278. Double clicking on this will give you a dialog with options for 
  279. enable/disable 3d dialogs, dialog border style and dialog background 
  280. style. After choosing your desired 'look' click on OK and this will become
  281. active for all subsequent dialogs.
  282.  
  283. If you'd prefer a colour other than grey alter the Windows 'Button Face'
  284. system colour (use the colour applet from the control panel) and this will
  285. become the background colour of your dialogs.
  286.  
  287.  
  288. SELECTIVE DISABLING
  289.  
  290. In some cases, using the 3D extensions causes a problem in conjunction
  291. with another program.  To avoid this, add the following information to your
  292. WIN.INI file:
  293.  
  294. [Dlg3d disable]
  295. d:\path\fullname.exe=OFF
  296.  
  297. where the filename you give must be the full path & name of the program
  298. you're finding troublesome.  The dialog extensions will then avoid this
  299. program.
  300.  
  301. -----------------------------------------------------------------------
  302.  
  303. HOW TO REGISTER THE WINDOWS DIALOG EXTENSIONS
  304.  
  305. Registration and initial support contact for this software is handled by
  306. the software publishers SP Services. A wide variety of payment options
  307. are available; choose the method most convenient to you. Please note that
  308. payment is required with order except from UK government organisations
  309. and UK plc companies, who may request invoicing at an additional charge of
  310. 5 pounds per month unpaid after 30 days.
  311.  
  312. To register a copy of the file dialog extenders send your name and address
  313. plus either a Cheque, Postal Order or International Money Order for the
  314. required sum, made payable to SP Services, or your Visa, Mastercard or
  315. American Express number plus the card expiry date, to:-
  316.  
  317.    SP Services
  318.    PO Box 456
  319.    Southampton
  320.    SO9 7XG
  321.    United Kingdom
  322.  
  323. or fax the card number, expiry & address details to  0703 550037
  324. (international:  +44 703 550037), or send them by e-mail to
  325. sphipps@cix.compulink.co.uk or to account 100016,1625 on CompuServe, or
  326. transfer sterling funds pre-paid to the following account:
  327.  
  328. Royal Bank of Scotland, 1 College Place, Southampton,
  329. Sort code 16-31-37, account 00237689, name SP Services
  330.  
  331. Payment may be made (fully pre-paid please) in US dollars to account
  332. number SPSERV-USDC at the same bank.  If you use bank transfer,
  333. please also fax or mail confirmation of the transfer and order.
  334.  
  335.  
  336. Pricing for the file dialog extenders is a follows:-
  337.  
  338.    Up to 5 copies    10.00 pounds each
  339.    6-10 copies        8.50 pounds each
  340.    over 10 copies     8.00 pounds each
  341.  
  342. A registration form may be found in REGISTER.HLP
  343.  
  344. Note that NO DISK is included in this price as you already have the software!
  345. If you really want a disk, send an additional 5 pounds or 10 dollars to cover
  346. the extra costs involved.  The disk we'll send includes current versions of
  347. all SP Services shareware products.
  348.  
  349. All credit card payments are charged in pounds sterling; conveniently, your
  350. credit card company conduct all the messy business of currency exchange for
  351. you at relatively low cost.
  352.  
  353. Cheque, postal order and bank draft payment may be made in pounds sterling or
  354. US dollars, pricing in dollars to be calculated at 2 dollars to the pound.
  355. Please indicate whether you need a receipt when you order.  VAT is not charged
  356. by SP Services at this time.
  357.  
  358. You can calculate the price for the number of copies required by entering the
  359. number of copies you require into the 'copies' field on the programs
  360. Registration dialog. The price will then be displayed on the dialog.
  361.  
  362. When you receive your registration details enter the name, registration number
  363. and serial number as supplied into the appropriate fields on the Registration
  364. dialog and click on OK. These must be entered exactly as supplied. Once
  365. entered successfully the Shareware reminder and timeout will be disabled and
  366. your name and serial number will appear on the About dialog box.  You may then
  367. delete REGISTER.HLP if you wish.
  368.  
  369. You get the registration dialog by selecting the Register button from the
  370. Shareware Reminder dialog box. This will appear after closing the About dialog
  371. on an unregistered copy of the program. The About dialog is available from the
  372. system menu of a file open or close dialog of an application (that uses
  373. commdlg.dll) when the File Dialog Extensions are installed.
  374.  
  375.  
  376. NOTE ON CREDIT CARDS
  377.  
  378. If paying with credit card via mail or fax please include your signature on
  379. your registration request.  We sadly cannot accept credit card payments if
  380. yours is a PO Box address.  Please ensure the address you cite is the same
  381. one your credit card statements are sent to.  All these conditions are
  382. imposed by our bank and are outside our control - sorry.
  383.  
  384. -----------------------------------------------------------------------
  385.  
  386. DISCLAIMER AND AGREEMENT
  387.  
  388. Users of the Windows Dialog Extensions must accept this disclaimer of
  389. warranty. If you do not accept this disclaimer, do not use the programs.
  390.  
  391. THE WINDOWS DIALOG EXTENSIONS LIBRARY IS SUPPLIED AS IS. THE AUTHOR
  392. DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
  393. LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY
  394. PURPOSE. THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR
  395. CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THE WINDOWS DIALOG
  396. EXTENSIONS, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY
  397. OF SUCH DAMAGES.
  398.  
  399. THE LICENCE AGREEMENT AND WARRANTY SHALL BE CONSTRUED, INTERPRETED AND
  400. GOVERNED BY THE LAWS OF ENGLAND AND WALES. YOU MAY HAVE OTHER RIGHTS
  401. WHICH VARY FROM ONE STATE TO ANOTHER.
  402.  
  403. The Windows Dialog Extensions are shareware, and are provided at no charge
  404. to users for evaluation. Feel free to share it with your friends and
  405. colleagues, but please do not give it away altered or as part of another
  406. system. The essence of shareware software is to provide computer users
  407. with quality software without high prices, and at the same time to
  408. provide incentive for programmers to continue to develop new products.
  409.  
  410. If you find the Windows Dialog Extensions useful, and you are continuing
  411. to use it after the trial period of 28 days, you must make a registration
  412. payment as indicated in the How to Register section of this document. In
  413. return you will be given a user name, serial number and registration
  414. number to disable the shareware reminders. This information will be good
  415. for all future shareware releases of the extensions. You will be informed
  416. when such releases become available.
  417.  
  418. A site licence for over 10 copies may be obtained at a reduced cost by
  419. contacting SP Services by post or email.
  420.  
  421. Any person or organisation wanting to distribute the File Dialog Extensions
  422. for profit must first contact SP Services by post or email for authorisation.
  423.  
  424.  
  425. Copyright for this software remains the property of:
  426.  
  427.    Mark Woollard
  428.    29 Baskerville Lane
  429.    Lower Shiplake
  430.    Henley-on-Thames
  431.    Oxon RG9 3JY
  432.    United Kingdom
  433.  
  434. All contact should be made with SP Services in the first instance.
  435.  
  436.  
  437. Windows is a trademark of Microsoft Corporation.
  438.  
  439.  
  440.  
  441. NOTES
  442.  
  443. Dialog3d has no effect with Microsoft Word. This is because MS Word does not
  444. use the standard Windows dialog routines but its own internal routines and
  445. methods to achieve the same result.  The same is true of any program
  446. which does work that should be left to Windows.
  447.  
  448.  
  449.  
  450. VERSION HISTORY
  451.  
  452. Windows Dialog Extenders Bundle
  453.  
  454. 11/1/93            First release
  455. 14/2/93            Second release
  456. 16/5/93            Third release
  457.  
  458.  
  459. Common File Dialog Extensions
  460.  
  461. 21/11/92   V1.0  - First release
  462. 23/11/92   V1.0a - Fix for problems with Rename error dialogs
  463. 24/11/92   V1.0b - Fix for problems with Make Dir, timeout increased
  464.                    to 45 mins
  465. 30/11/92   V1.0c - Timeout removed and replaced with occasional
  466.                    reminder dialogs
  467. 22/12/92   V1.0d - Fix for problems with PM and FM browse dialogs
  468. 23/12/92   V1.0e - Fix for problems with MS QuickC for Windows edit
  469.                    project dialog
  470. 9/1/93     V1.1  - Support for multi selection dialogs and addition
  471.                    of help menu entry. Now bundled with Dialog3d as
  472.                    Windows Dialog Extensions
  473. 14/2/93    V1.2  - Editable file attributes, buttons duplicated on system
  474.                    menu + fixes for problems reported to date.
  475. ...
  476. 16/5/93    V1.4  - Bug fixes plus selective turn-off
  477.  
  478. Dialog 3D
  479.  
  480. 3/1/93     V1.0  - Initial release
  481. 5/1/93     V1.0a - Sorts out problems with SS_SIMPLE Static controls +
  482.                    works with MS access.
  483. 11/1/93    V1.0b - Bundled with Dialog3d as Windows Dialog Extensions, fix
  484.                    for static controls with < 256 chars (bypasses bug in
  485.                    ctl3d).
  486. 14/2/93    V1.1  - Now offers choice of dialog 'looks' selectable through
  487.                    control panel applet.
  488. ...
  489. 14/5/93    v1.4  - Bug fixes (esp. WinCIM), selective turn-off, new name
  490.  
  491.  
  492. NOTE TO EXISTING USERS
  493.  
  494. As from v1.4, DIALOG3D.EXE has been renamed 3DDIALOG.EXE to avoid a name 
  495. conflict with Ventura.  Also, all parameters are now stored in SP-SERV.INI
  496. instead of in WIN.INI, apart from registration details - this will mean that
  497. you will need to restore your preferences after installing this version.